Crate alloy_primitives

alloy-primitives

Primitive types shared by alloy, foundry, revm, and reth.

Types

• Unsigned integers re-exported from ruint
• Signed integers, as a wrapper around ruint integers
• Fixed-size byte arrays via FixedBytes
  • a macro wrap_fixed_bytes for constructing named fixed bytes types
  • Address, which is a fixed-size byte array of 20 bytes, with EIP-55 and EIP-1191 checksum support

Examples

This library has straightforward, basic, types. Usage is correspondingly simple. Please consult the documentation for more information.

use alloy_primitives::{U256, Address, FixedBytes, I256};

// FixedBytes
let n: FixedBytes<6> = "0x1234567890ab".parse().unwrap();
assert_eq!(n.to_string(), "0x1234567890ab");

// Uint
let mut n: U256 = "42".parse().unwrap();
n += U256::from(10);
assert_eq!(n.to_string(), "52");

// Signed
let mut n: I256 = "-42".parse().unwrap();
n = -n;
assert_eq!(n.to_string(), "42");

// Address
let addr_str = "0x66f9664f97F2b50F62D13eA064982f936dE76657";
let addr: Address = Address::parse_checksummed(addr_str, None).unwrap();
assert_eq!(addr.to_checksum(None), addr_str);

// Address with custom chain id
let addr_str = "0x66F9664f97f2B50F62d13EA064982F936de76657";
let addr: Address = Address::parse_checksummed(addr_str, Some(30)).unwrap();
assert_eq!(addr.to_checksum(Some(30)), addr_str);

Re-exports

• pub use aliases::BlockHash;
• pub use aliases::BlockNumber;
• pub use aliases::ChainId;
• pub use aliases::Selector;
• pub use aliases::StorageKey;
• pub use aliases::StorageValue;
• pub use aliases::TxHash;
• pub use aliases::TxIndex;
• pub use aliases::TxNumber;
• pub use aliases::I128;
• pub use aliases::I16;
• pub use aliases::I256;
• pub use aliases::I32;
• pub use aliases::I64;
• pub use aliases::I8;
• pub use aliases::U128;
• pub use aliases::U16;
• pub use aliases::U256;
• pub use aliases::U32;
• pub use aliases::U512;
• pub use aliases::U64;
• pub use aliases::U8;
• pub use ruint;
• pub use ruint::uint;
• pub use ruint::Uint;
• pub use tiny_keccak;
• pub use tiny_keccak::Hasher;
• pub use tiny_keccak::Keccak;

Modules

• aliases
  Type aliases for common primitive types.

Macros

• wrap_fixed_bytes
  Wrap a fixed-size byte array in a newtype, delegating all methods to the underlying crate::FixedBytes.

Structs

• Address
  An Ethereum address, 20 bytes in length.
• BigIntConversionError
  The error type that is returned when conversion to or from a integer fails.
• Bloom
  Ethereum 256 byte bloom filter.
• Bytes
  Wrapper type around Bytes to deserialize/serialize “0x” prefixed ethereum hex strings.
• FixedBytes
  A byte array of fixed length ([u8; N]).
• Signed
  Signed integer wrapping a ruint::Uint.

Enums

• AddressError
  Error type for address checksum validation.
• BloomInput
  Input to the Bloom::accrue method.
• ParseSignedError
  The error type that is returned when parsing a signed integer.
• Sign
  Enum to represent the sign of a 256-bit signed integer.

Constants

• BLOOM_BITS_PER_ITEM
  Number of bits to set per input in Ethereum bloom filter.
• BLOOM_SIZE_BITS
  Size of the bloom filter in bits
• BLOOM_SIZE_BYTES
  Size of the bloom filter in bytes.

Functions

• keccak256
  Simple interface to the keccak256 hash function.

Type Definitions

• B64
  8-byte fixed array type.
• B128
  16-byte fixed array type.
• B256
  32-byte fixed array type.
• B512
  64-byte fixed array type.